---
title: 环境搭建指南
description: 详细的CActor框架安装和环境配置指南
category: 快速开始
order: 2
tags: [安装, 环境, 配置, 部署]
author: CActor团队
publishedAt: 2024-01-15
updatedAt: 2024-01-15
difficulty: beginner
---

# 环境搭建指南

本指南将详细介绍如何在不同操作系统上安装和配置CActor框架。

## 系统要求

### 最低要求

| 组件     | 要求                                                 |
| -------- | ---------------------------------------------------- |
| 操作系统 | Linux (Ubuntu 18.04+), macOS (10.14+), Windows (10+) |
| CPU      | x86_64 或 ARM64                                      |
| 内存     | 4GB RAM                                              |
| 存储     | 2GB 可用空间                                         |
| 网络     | 互联网连接                                           |

### 推荐配置

| 组件 | 推荐      |
| ---- | --------- |
| CPU  | 8核心+    |
| 内存 | 16GB+ RAM |
| 存储 | SSD 10GB+ |
| 网络 | 千兆网络  |

## Linux 安装

### Ubuntu/Debian

```bash
# 更新包管理器
sudo apt update
sudo apt upgrade -y

# 安装依赖
sudo apt install -y curl wget git build-essential

# 添加CActor仓库
curl -fsSL https://repo.cactor.dev/gpg | sudo apt-key add -
echo "deb https://repo.cactor.dev/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cactor.list

# 安装CActor
sudo apt update
sudo apt install -y cactor
```

### CentOS/RHEL

```bash
# 安装依赖
sudo yum install -y curl wget git gcc gcc-c++ make

# 添加CActor仓库
sudo tee /etc/yum.repos.d/cactor.repo <<EOF
[cactor]
name=CActor Repository
baseurl=https://repo.cactor.dev/centos/\$releasever/\$basearch/
enabled=1
gpgcheck=1
gpgkey=https://repo.cactor.dev/gpg
EOF

# 安装CActor
sudo yum install -y cactor
```

### Arch Linux

```bash
# 使用AUR助手安装
yay -S cactor

# 或手动安装
git clone https://aur.archlinux.org/cactor.git
cd cactor
makepkg -si
```

## macOS 安装

### 使用Homebrew（推荐）

```bash
# 安装Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 添加CActor tap
brew tap cactor/tap

# 安装CActor
brew install cactor
```

### 使用MacPorts

```bash
# 更新MacPorts
sudo port selfupdate

# 安装CActor
sudo port install cactor
```

### 手动安装

```bash
# 下载安装包
curl -L https://releases.cactor.dev/v2.1.0/cactor-macos-x86_64.tar.gz -o cactor.tar.gz

# 解压安装
tar -xzf cactor.tar.gz
sudo mv cactor /usr/local/bin/

# 验证安装
cactor --version
```

## Windows 安装

### 使用Windows包管理器

```powershell
# 使用Chocolatey
choco install cactor

# 使用Scoop
scoop bucket add cactor https://github.com/cactor/scoop-bucket.git
scoop install cactor

# 使用winget
winget install CActor.CActor
```

### 使用安装程序

- 下载Windows安装程序：[cactor-windows-installer.exe](https://releases.cactor.dev/v2.1.0/cactor-windows-installer.exe)
- 运行安装程序并按照提示操作
- 重启命令提示符或PowerShell
- 验证安装：`cactor --version`

### WSL安装

在Windows Subsystem for Linux中：

```bash
# 启用WSL2
wsl --install

# 安装Ubuntu
wsl --install -d Ubuntu

# 在WSL中按照Linux安装步骤操作
sudo apt update
sudo apt install -y cactor
```

## 从源码编译

### 准备编译环境

```bash
# 安装编译依赖
# Ubuntu/Debian
sudo apt install -y build-essential cmake git libssl-dev

# CentOS/RHEL
sudo yum groupinstall -y "Development Tools"
sudo yum install -y cmake git openssl-devel

# macOS
brew install cmake git openssl
```

### 编译安装

```bash
# 克隆源码
git clone https://github.com/cactor/cactor.git
cd cactor

# 创建构建目录
mkdir build
cd build

# 配置构建
cmake .. -DCMAKE_BUILD_TYPE=Release

# 编译
make -j$(nproc)

# 运行测试
make test

# 安装
sudo make install
```

### 自定义编译选项

```bash
# 启用调试模式
cmake .. -DCMAKE_BUILD_TYPE=Debug

# 启用性能分析
cmake .. -DENABLE_PROFILING=ON

# 禁用网络功能
cmake .. -DENABLE_NETWORK=OFF

# 自定义安装路径
cmake .. -DCMAKE_INSTALL_PREFIX=/opt/cactor
```

## 环境配置

### 环境变量

添加到 `~/.bashrc` 或 `~/.zshrc`：

```bash
# CActor环境变量
export CACTOR_HOME=/usr/local/cactor
export PATH=$CACTOR_HOME/bin:$PATH
export CACTOR_LOG_LEVEL=INFO
export CACTOR_MAX_MEMORY=4g
```

### 系统配置

创建全局配置文件 `/etc/cactor/cactor.conf`：

```hocon
cactor {
  system {
    # 系统名称
    name = "production"

    # 工作线程数
    threads = 8

    # 最大内存使用
    max-memory = "4g"
  }

  logging {
    # 日志级别
    level = "INFO"

    # 日志文件
    file = "/var/log/cactor/cactor.log"

    # 日志轮转
    rotation {
      max-size = "100MB"
      max-files = 10
    }
  }

  network {
    # 默认端口
    port = 8080

    # 绑定地址
    host = "0.0.0.0"

    # 连接超时
    timeout = 30s
  }
}
```

### 服务配置

#### systemd服务（Linux）

创建 `/etc/systemd/system/cactor.service`：

```ini
[Unit]
Description=CActor Framework Service
After=network.target

[Service]
Type=forking
User=cactor
Group=cactor
ExecStart=/usr/local/bin/cactor daemon
ExecReload=/bin/kill -HUP $MAINPID
KillMode=process
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target
```

启用服务：

```bash
sudo systemctl enable cactor
sudo systemctl start cactor
sudo systemctl status cactor
```

#### launchd服务（macOS）

创建 `~/Library/LaunchAgents/dev.cactor.plist`：

```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>dev.cactor</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/cactor</string>
        <string>daemon</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
```

加载服务：

```bash
launchctl load ~/Library/LaunchAgents/dev.cactor.plist
launchctl start dev.cactor
```

## 验证安装

### 基本验证

```bash
# 检查版本
cactor --version

# 检查配置
cactor config show

# 运行诊断
cactor doctor
```

### 性能测试

```bash
# 运行基准测试
cactor benchmark

# 内存测试
cactor test memory

# 网络测试
cactor test network
```

### 示例程序

```bash
# 创建测试项目
cactor init test-project
cd test-project

# 运行示例
cactor run examples/hello-world.cj
```

## 故障排除

### 常见问题

#### 权限问题

```bash
# 修复权限
sudo chown -R $USER:$USER ~/.cactor
sudo chmod -R 755 ~/.cactor
```

#### 端口冲突

```bash
# 检查端口占用
sudo netstat -tlnp | grep :8080

# 修改配置文件中的端口
vim ~/.cactor/cactor.conf
```

#### 内存不足

```bash
# 检查内存使用
free -h

# 调整内存限制
export CACTOR_MAX_MEMORY=2g
```

### 日志分析

```bash
# 查看系统日志
cactor logs system

# 查看错误日志
cactor logs error

# 实时监控
cactor logs -f
```

## 下一步

安装完成后，你可以：

- [运行Hello World示例](/docs/quick-start#hello-world-示例)
- [学习核心概念](/docs/core-concepts)
- [查看配置参考](/docs/api-reference/configuration)
- [加入社区讨论](https://community.cactor.dev)

> **注意**: 生产环境部署前，请仔细阅读安全配置指南，确保系统安全。
